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S-DYNAMICS 


S-Dynamics is a software system that lets you describe and control the scheduling and synchroniza- 
tion of events in time. It is normally used in conjunction with S-Geometry and S-Render to script 
animated computer graphics. You should be familiar with basic S-Geometry operation before you 
use S-Dynamics. See the documents "S-Geometry” and “S-Render” for more information. 


S-Dynamics has facilities for describing actions that occur in parallel or sequentially. You start by 
creating an animation script. A script is the whole collection of sequences, objects, motions, and 
parameters that go into the description of a piece of animation. When a script is animated, all of 
these parameters and all of the timing information are combined to produce a series of descriptions 
of discrete frames. 


These frames can be displayed by S-Geometry (as wire frames, or with opaque faces), or by 
S-Render (as full color, smooth shaded, antialiased images). The displayed frames can be saved 
for real-time playback, either into the main memory of the Lisp Machine, to a videotape recorder 
under computer control, or to a single frame film recorder. 


GETTING STARTED 


Entering S-Dynamics 


ue 


Press SELECT G. The S-Geometry frame will appear. tf a S-Geometry frame already exists, 
this merely “exposes” it by moving it to be on top of other Lisp Machine windows. tfno 
S-Geometry frame exists (this might be the first attempt to use it after a cold boot of the 
Lisp Machine), typing SELECT G will create a new one and then expose that. 


Move the mouse cursor to the gray stipple pattern beneath the basic interface menus. See 
the section “Using the Mouse” below. 


Click (R) on the geometry frame (on the gray stipple). This menu appears: 


GEOMETRYFRAME 


cose deexposed gray 
Choose background gray 


re frame 


refresh panes 
x 
get Geexposed pane menu) 


reveal hidden pane (menu) 


Click on [select configuration]. This menu of geometry frame configurations appears: 


Configurations 


load fron a file 
BIG-LISTENER 
BIG-VIEWER - 


o 
GEOMETRY-NO-MENUS 
NO-CONSTRAINTS 
PREVIOUS 


Click on (DYNAMICS). The display reconfigures to include the S-Dynamics Script Editor. 


' To reselect the S-Dynamics Script Editor (for example, after having selected a lisp listener), 


press SELECT @ (@ is the <circ!e> key at the top center of the keyboard). 


Using the Mouse 


The mouse is a pointing device that you move around on a flat surface. These motions are sensed 
by the Lisp Machine, which responds by moving a cursor around on the screen in a corresponding 
manner. The shape of the cursor varies, depending on context. 


The three buttons on the mouse are referred to as left, middle, and right. They are used to specify 
operations to be performed. S-Dynamic’s menus are mouse-sensitive; that is, clicking one of the 
mouse buttons on a menu item causes some action to occur. When you move the mouse cursor over 
a menu item, an outline box appears around the item. Clicking on the boxed item causes the action 


to occur. 


Mouse actions are represented in the following manner: 


Appearance Representing 
(Color) Menu item, always click left. 
(Rivoli AL? Mouse clicks: R-click right, M-click middle, 


L-click left. 


FUNCTION X moves the mouse between the black-and-white screen and the color screen. The mouse 
documentation line, displayed in reverse video at the bottom of the screen, contains documentation 
on the current meaning of mouse clicks. 


BASIC CONCEPTS 


Time 


Time is the dimension that describes “when” you are. All dynamics are specified in terms of time. 
As a script is animated, its value of time ramps up from zero to the runtime of the script. 
S-Dynamics uses the following timing concepts: 


Continuous time is a smooth flow. Between any two continuous times there is always 
another one. Measurements of continuous time are normally in floating point ("real") 
representation. (For example, 3.26 seconds.) 


Discrete time is the result of slicing continuous time into a series of intervals of constant 
length. These intervals are normally numbered sequentially using fixed point ("integer") 
notation. (For example, 73 frames.) 


Absolute time is measured in terms of real world units (such as seconds or frames). An 
absolute time corresponds to certain amount of real time in the context of an animation 
viewed at normal speed. 


Relative time is specified as some point during a certain interval of time. It is usually 
specified as a fractional value (a percentage, or as a number between 0 and 1) where 0% 
means the beginning of the interval and 100% means the end of the interval. Hence the 
absolute time value of a relative time specification depends on the current definition of the 
referenced interval. 


Instant is a point in time (a “dot” on the time line). It usually represents a time when 
something starts or ends. An instant can be specified either as an absolute time (1.5 
seconds) or as a relative time (23% of the way along a given interval). 

Duration is a length of time (the “distance” between two points on the time line). It normally 
specifies how far one instant is before or after another. A duration can be either absolute or 
relative. 

Interval is a period of time (a “segment” on the time line). An interval is the time between 
two instants (the start and the finish). 


Sequences 


Sequences are used in S-Dynamics to describe the sequencing of events. A sequence is an interval 


during which something occurs. A simple sequence associates a object and a motion. The interval 
describes the time during which the object undergoes the motion. The object, the type of motion, 
and related specifications are called the properties of the sequence. 


A sequence can contain any number of subsequences. Normally subsequences are specified by start 
and finish times which are relative to their parent sequence. A subsequence will inherit the 

properties of its parent sequence, but properties specified for the subsequence itself will override 
those inherited defaults. This inheritance allows Sequences to be structured using convenient levels 
of abstraction, which in turn helps to control the complexity of the script. 


Scripts 


A script is a top level sequence that contains the whole collection of sequences, objects, motions, 
curves and parameters that describe a piece of animation. Scripts are saved in files between work 
sessions. When a script is read in from a file, it will make sure that all of the geometric objects 

that it refers to are also read in (via S-Geometry). 


Script Editor 


The Script Editor is a window in the window system of the Lisp Machine’s console. The Script Editor 
provides interative tools to allow you to create, edit and debug S-Dynamics scripts in diagramatic 
form. Normally the Script Editor is used in conjunction with the S-Geometry system to allow direct 
visual inspection of the images described by the script, and to provide graphical feedback while 
making interactive adjustments to animation/geometrical parameters. 


Animating Scripts 


A script is a static description of an animation. The task of interpreting the script to produce the 
individual frames is called animating the script. During this process the continuous time frames of 
the sequences are “sliced” into discrete frames. Each sequence which spans the current frame is 
activated and performs its frame action. A description of the scene is sent to the geometric 

database causing the animated objects to move incrementally. An image of this scene can then be 
made, either a B&W line drawing by S-Geometry, or a full color shaded image produced by S-Render. 


Recordings and Playback 


In normal usage the animation process converts from a symbolic script to a series of raster images. 
Since producing these images usually takes longer than the frame time (eg: 1/30 of a second), it is 
not possible to see the animated motion at the correct speed. The solution to this is to save 
recording of the images as they are produced onto some appropriate image recording media and 
then to play the images back at the correct speed after they have all been computed. In the case 
of the 1 bit B&W images produced by S-Geometry, it is practical to store these images as raster 

bit maps in the main memory of the Lisp machine itself. Playback can be obtained by simply doing 
a fast block transfer of that image data to the frame buffer of the machine’s console. Hence motion 
tests (“pencil tests”) can be made right on the lisp machine without any other equipment. In the 
Current release recording and playback of full color images is done using a video tape recorder 
under the control of the Lisp Machine. In a future release these two record/playback systems will 
be interchangeable and will be controlled by the same user interface. 


USING THE SCRIPT EDITOR 


When you first enter the Dynamics configuration of the S-Geometry frame, one new window appears 
and the others are rearranged. (See figure below.) The new window, the Script Editor, is the main 
user interface to the S-Dynamics system. Using the Script Editor you can interactively create, edit, 

or inspect scripts and the animation they specify. By default, the Script Editor is located at the 
bottom of the Geometry frame. The Camera Window, four menus and “Live Window" Lisp Listener of 
the Geometry configuration are moved up into the top of the Geometry frame. (The History Window 
gets buried under the listener.) Note: it is possible to create a Script Editor outside of the 
S-Geometry frame, but such an Editor is not very useful to the typical user. 
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Script Editor in the dynamics configuration of the S-Geometry frame 


Components of the Script Editor 
The Script Editor has five window panes: 


Label / Status pane says "S-Dynamics Script Editor” on the left side and the right shows the 
current sequence name (plus the script name if the current sequence is not the script itself), the 
frame rate (in frames-per-second), and the runtime for the script. 


Script Diagram pane displays a diagramatic representation of the current sequence (and any of 
its subsequences). Time runs from left to right. Sequences are shown as horizontal strips that run 
from their start time until their finish time. The mouse position is shown as a tick on a vertical 
crosshair cursor. The indicated time value is called the now time. 


A sequence diagram can be closed, meaning its internal details are hidden and you see only its 
name, or it can be open, allowing you to see what is going on inside. For example, if you click on 
an open bottom level sequence, you see a plot of its interpolation curve. For a higher level open 
sequence, you see the diagrams of the subsequences within it. 


S-Oynenics Script Editor 
g, 


Script “cubes® (36 fps, 1 sec)] 
‘t's Sequence. “cubes7020°, 
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Subsequences of a high level open sequence 


The sequence diagrams, and the “endpoints” of the sequence diagrams are mouse-sensitive, which 
means that they are highlighted when you move the mouse over them. To see a menu of editing 
operations to perform on sequences, click (R) on the sequence diagrams or their endpoints. | 


Continuous Absolute Time pane shows the numerical value of continuous absolute time (in 
seconds) that corresponds to the position of the now time cursor. The two small numbers in the 
upper left and upper right corners show the time values at the edges of the diagram. These 
numbers are mouse-sensitive, allowing you to set the end times of the diagram window (they are 
usually automatically set to correspond to the start and finish times of the current sequence). 


Discrete Frame Time pane shows the number of the frame interval that contains the now time. 
The little box with the number in it is positioned just at the trailing edge of the frame interval. The 
horizontal bar indicates the duration of this frame. 


Main Menu pane invokes various editor activities. The menu items are mouse-sensitive. 


(Select sequence] 


(Save script] 


(Display frame] 


(Animate script] 


Presents a menu of ways to select a new current sequence of the script 
editor: select a subsequence of the current sequence (by clicking on its 
diagram), select any subsequence of the current script (by clicking on its 
name in a menu showing nesting relationships), select any previously 


. edited script, create a new script, or read in a script saved in a file from 


a previous work session. See 


le sequence 
select sub-sequence 
sub-sequence menu 
ficne Logo (new colors) 
ficne Logo 
create new script 
read script from file 


Writes the current script to its specified file name, after asking for 
confirmation. WARNING: Saving the script does NOT automatically save 
the 3D objects referenced by the script. You must be sure to save them “by 
hand" from the 3D editor. In future releases, saving the script WILL save the 
3D objects referenced by it. 


Allows you to indicate a time with the now cursor and display the 
corresponding frame on the currently selected graphics destination, 
normally the 3D editor’s camera window. (See [Change modes) .) 


Sequentially displays each frame of the current script on the currently 
selected graphics destination, optionally saving each frame as it is 
created for eventual real-time playback. 


anine on and yECging DPerar 2 
action: record for realtime playback display only 
version: reuse previous recording start new 
animate: entire script just portion in diagram 
increment: 14 “shooting on ones" 
do it LJ - Abort 


Recording [action] allows you to specify if the animation should be 
recorded or not. [version] controls whether a new recording should be 
started or the old recording reused. [Animate] determines whether the 
whole script or just the frames shown in the script editor’s diagram pane 
are to be animated. [increment] allows you to do “fast run-throughs” of a 
script by skipping frames at animate time. (S-Dynamics will compensate 
during playback so that the overall runtime of the script is unchanged. 
The default value (1) means do every frame, a value of 2 means skip 

every other frame, and so on.) 


(P| ayback] 
Presents a menu for the real-time playback facility. See description of 
this menu in the next section “The Real-Time Playback Facility”. 


(Change modes] 
Allows you to set operating modes, default values, and so on, for the 
Script Editor itself (as opposed to a given script): 


hanae $-Dynar nodes: 
‘graphics destination: 3d-Editor Render a 
style of graphics: Wire-Frame Hidden-Line : 
default frene rate: 38 fps ; 
object visiblity: referenced objects onty all visible:pbjects 
frame label types: frames seconds percent bar field-chart 
frame label format: top bottom right left one-tine multi-line 
subsequence size: 852 


do it [J Abort 


The Real-Time Playback Facility 


The script name and the recording version number appear on the top line. Allows 
you to choose various modes of playback and select which recording to play. The menu items are: 


To stop a looping mode, type any character, or click on the Script Editor. 
(forward once] 
Play the animation once from the first frame to the last. 


(forward loop] 


Continually play forward. 


(backward once] 
Play the animation once from the last frame to the first. 


(backward loop] 
Continually play backward. 


(back and forth loop) 
Play forward, then backward, repeatedly. 


Te Ne 


(variable speed] 
Pops up a slider that controls the speed of the playback. Hence "1" is 
normal, "0.5" means half speed, and "-2.0" is twice normal speed, running 
backwards. Playback loops in both directions. 


(scroll with mouse] , 
Uses the “now time” cursor of the Script Editor to control which frame is 
displayed. Moving the cursor with the mouse causes the playback to run 
forward or backward correspondingly. 


(version menu) 
Allows you to select a previous version of the recording of this script to 
playback, and this menu comes back with that version selected. If you 
Click on [Playback] before you have animated the script, this menu 
appears: 


This [Animate script) is the same as the one on the menu pane. 


wae ean i _ ~— wees = 


Operating on Sequences 


The sequence diagrams displayed by the Script Editor are mouse-sensitive, so you Can simply point 
at a sequence and click to indicate that you want to operate on it. You can edit both the sequence 
diagrams and the “endpoints” of the sequences. For both sequence and endpoints, three different 
functions are assigned to each of the three buttons on the mouse. Mouse clicks on sequences: 


Sequence (L) opens or closes this sequence, reversing its state. 


Sequence (mM) pops up a menu that shows current values of sequence properties and allows you to 
change these values. See the section “Editing Animation Properties.” 


Sequence (R) pops up a menu of operations related to the indicated sequence. 


aie 
delete 
add sub-sequences 
swap sub-sequences 
edit properties 
select this 


select parent 

select script 
open all 
close all 
deactivate 


(Delete) Removes this sequence permanently, after receiving confirmation. 
[Add sub-sequences] Adds one or more new parallel subsequences. See the next section. 


(Swap sub-sequences]) Swaps vertical ordering of two subsequences. 


(Edit properties) 


(Select this] 


(Select parent] 


(Select script] 


(Open all) 


(Close ail] 
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Pops ups edit/inspect menu, just like sequence (Mm). 
Zooms in on this sequence’s diagram. 

Zooms out to this sequence’s parent diagram. 

Zooms out to this sequence’s script diagram. 

Opens diagrams of this sequence and all its subsequences. 


Closes diagrams of this sequence and all its subsequences. 


(Deactivate) Deactivates this sequence. 


Adding Subsequences 


Clicking (R) on asequence, then [add subsequence) presents this menu: 


odd tlank parallel subsequences! 
add one 
add several 


add typleal sets of metions for Kheyframing: 


XYZ move 
xyz rotate, xyz nove 
xyz rotate, xyz move, scale 
xyz rotate, xyz move, xyz scale 


(add one] 
Adds a single new subsequence, in parallel to the others, at the bottom of the parent. 


{add several] 
Adds several new subsequences all at once. "Several" is specified with a slider: 


(xyz move] 


Adds 3 subsequences for parallel xyz movement. The “motion types” of these 
subsequences are preset to global x, y and z moves. See the chapter “Editing 
Animation Properties”, especially the section “Multiple parameter editing”. 


(xyz rotate, xyz move] 
Adds 6 subsequences for parallel xyz movement and xyz rotation. 


(xyz rotate, xyz move, scale] 
Adds 7 subsequences for parallel xyz movement, xyz rotation and overall scaling. 


(xyz rotate, xyz move, xyz scale] 
Add 9 subsequences for parallel xyz movement, xyz rotation and xyz scaling. 


Operating on Endpoints 


Endpoint (L) adjusts the time of this endpoint interactively with the mouse. The sequence end 
begins to track with the now cursor until the next click. 


Endpoint (") expands the indicated subsequence endpoint to be coincident with the corresponding 
endpoint of the parent Sequence (0% relative time for left endpoints and 100% for right endpoints). 


Endpoint (R) allows editing the properties of the indicated endpoint. A menu pops up showing the 
Current values of the endpoint's time specification and its Parameter value and then allows you to 
adjust them. Editing parameter values is discussed in the section "Editing Animation Properties.” 


The time specification of an endpoint consists of two parts: a numerical time value and the time 
frame on which that value is based. The time frame can be either absolute, in which case the time 
value will be in seconds, or else it is relative to a sequence and the value is a percentage of the 
duration of that sequence. Like the time specification, the [start time) (or [end time] ) item 
consists of two parts. Each part is seperately mouse-sensitive and can be adjusted independently 
of the other: 


start time: 0.0 secondd absolute 
start parameter: None 


do it (J Abort [) 


a ei! , 4 ‘ ad 

start time: 49.56% relative to: Script “demo” runtine: 1 sec 
start parameter: None 

do it [ 


Abort [) 


If you click on the time value (first mouse sensitive item) this menu will pop up: 


on sequence diagran 


with slider control 
type in value 


on sequence diagram] -- allows you to specify a time with the now cursor on the Script 
Editor’s sequence diagram pane. Note that this can only be used to specify those time 
values which fall within the interval currently displayed in the diagram pane. 


(with slider control) -- pops up a graphical "slider control" which is adjusted with the 
mouse. The range of the slider is generally twice the current duration of the sequence. The 


Slider will be calibrated in either percentages (for relative time) or seconds (for absolute 
time): 


a 


(type in value] -- pops up a menu displaying the current value. Click on this item to type in 
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a new value, finish by pushing RETURN, click on the box next to EXIT to use the new value. 
(Note: in a future release this will go directly to reading the number you type, without the 
extraneous selecting and exiting.) 


If you click on the time frame description (the second mouse sensitive item in the endpoint time 
Specification) this menu will pop up: 


absolute ; 
relative to perent sequence 


[absolute] -- converts the time into an absolute specifcation. The time value is adjusted to 
correspond to the same instant as the previous Specifcation. The numerical value of the time 
specification will change to compensate for the change in “units”. By default, the end times 
of a script are specified as absolute. 


(relative to parent sequence) -- converts the time into a specifcation relative to the parent 
sequence. (Here “parent” means the sequence containing the (sub)sequence of which this 
endpoint is a part.) The time value is adjusted to correspond to the same instant as the 
previous specifcation. The numerical value of the time specification will change to 
compensate for the change in “units”. By default, the end times of all subsequences are 
specified as being relative to their parent sequence. Note that this option will not appear on 
the menu if there is no parent sequence, such as for a script. 


(...] -- does nothing. It is just a reminder that in a future release it will be possible to 
specify times relative to any sequence. This item will present a menu of sequences. 


Cursor Styles 


When the mouse is over the sequence diagram pane, it is shown as a vertical crosshair with a little 
“tick mark" indicating the vertical position of the mouse. The shape of that mark Changes to 
indicate the state of the interactive utilities of the Script Editor such as [swap subsequences] or 
endpoint (L). Shown below are the four styles: 
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select time 
move endpoint 


mouse scroll! playback 
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EDITING ANIMATION PROPERTIES 


When you edit the properties of a script, sequence, or endpoint, some of the following properties 
are displayed along with their current values. Point at the value and click to reselect or adjust that 
value. Values are printed within square brackets ([ ]) to indicate that the value shown is 
unspecified in this sequence and so is being supplied automatically, often by inheriting from a 
parent sequence. 


nane: 
activated: 
subsequences: Normal Concurrent 
anim object: CUBE 


motion type: Rotate 

curve type: Slow-in/Slow-out 

start value: (degrees) 45.0 
end value: (degrees) 63.7 


(name) -- All sequences have aname. A name is automatically generated if you do not 
supply one. 


(pathname) -- (scripts only) This is the file system pathname to which the script is written 
when you want to save it permanently. This defaults to a file in your home directory with the 
Same name as the script. The default file type is ".script”. 


(frames per second) -- (scripts only) The rate at which continuous time is divided into 
discrete frames. Can be set to several standard values (24 fps for film frames, 30 fps for 
video frames, 60 fps for video fields). You can also set it to any other value required for 
special applications. 


[activated] -- This is normally YES, setting it to NO turns off an entire sequence (and all of 
its subsequences) temporarily. 


[subsequences] -- normal OF concurrent. This controls the relationship of any subsequences 
to this one. Normal subsequences are allowed to fall anywhere within the parent. Concurrent 
subsequences are constrained to start and end at the same time as their parent. The 
"keyframe editor” described below expects concurrent subsequences. (See the section 
“Multiple Parameter Editing”.) 


(anim object] -- This is the object that is being controlled by this sequence. Clicking on this 
item allows you to select from a list of all objects known to S-Geometry, as well as CAMERA 
and NONE. A value of NONE means to inherit this value from the parent sequence. 
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[motion type) -- This is the type of motion that is being applied to the (anim object) by this 
sequence. Clicking on this item allows you to select from a large set of motions defined by 
geometrical operators in S-Geometry (see below). While most “motion types” are geomteric 
in nature some represent other sorts of actions, such as changes in the S-Render attributes of 
an object, such as its color. A value of NONE means to inherit this value from the parent 
sequence. 


(curve type] -- Controls the rate of interpolation between (start value) and [end value). 
Clicking on this item presents a menu of standard curve shapes and tools for defining your 
own. A value of NONE means to inherit this value from the parent sequence. 


(start value] / [end value) -- These are the value of the parameter to the (motion type) at 
the start and end of the sequence. Parameter values at intermediate times along the 
sequence are formed by interpolation between these two values and according to the curve. 


(curve edit] -- The last item on the menu appears when needed. It would be SKETCH to 
invoke the sketched curve editor for sequences whose curve type is SKETCHED. For SLOW-IN 
and SLOW-OUT curves this item adjusts the “exponent” of the curve shape. 


Motion Types and Parameters 


The various motion types and the parameters that they accept come in different types. These 

types are informal families of related concepts. For example, the motion type “global X move” 
requires a parameter that is conceptually a distance (hence a simple numerical value). Other 
numeric types include rotation angle and scale factor. Viewer is anonnumeric type that describes a 
viewing transformation (a “camera”). 


A motion type (of a sequence) is the action that is to be applied to the animation object of a 
sequence. The animation object is a 3D object in the S-Geometry database. Most motions require 
at least one parameter, to specify “how much” of the specified motion. There is a large collection 
of motion types, there will be more available in future releases. Click on the [motion type] item to 
pop up a menu of classes of motions. 


Choose operation to perforn 


none 
camers operations 
object scalings 
object rotations 
object translations 
niscellaneous operations 


Choose one of these to pop up a menu of several of that sort of motion. 


interpol 


r . e2e - mo ‘ . . "i 
ate between vieus Rotate 


: % rotate 
Move global in | Y rotate 
Move global in Y¥ Z rotate 


Move global in 2 


Rotate Up (Local) 
Rotate Down (Local) 
Rotate Left (Local) 
Rotate Right (Local) 

Rotate Clock-wise (Local) 

Rotate Counter-C-W (Local) 


Move ForwardBack (Local) 
Move UpDown (Local) 
Move LeftRight (Local) 


Move aim-point in 
Move aim-point in ¥ 
Move aim-point in 2 


Move global in x 
Move global in ¥ 
Move global in 2 


Rotate - azimuth 
Rotate - altitude 


Zoom 


Move Forward (Local) 
Move Back (Local) 
Move Left (Local) 
Move Right (Local) 
Move Up (Local) 

Move Down (Local) 


Move along axis 


| Choose operation to perforn” 
Make Invisible 
Make Visible (no-op) ! 


Curve type 


A curve type (ofa Sequence) is the shape of the interpolation curve that describes how “relative 
sequence time" is mapped into the fractional value used to interpolate between the extreme values 
of the parameters to the motion type. You can select six defined Curve types from a menu (in a 
future release this list will include a generalized spline curve): 


(hold) Constant value 
(linear) Simple ramp 

(slow-in) Accelerate from a stop 
(slow-out] Decelerate to a stop 


(slou-in/slow-out] Accelerate from a Stop and then decelerate toa stop 


(sketched) A hand drawn curve of arbitrary shape 


Slow-in and slow-out are implemented as exponential curves, hence they have a shape parameter 
Called the exponent. The default exponent is 2.5, or somewhere between a quadric and a cubic 
parabola. Adjusting this value will determine just how slow the slow-in is. An exponent of 1 would 
give a linear ramp. Larger values correspond to very high acceleration/deceleration. 
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2 OF / 


Sketched curves Can take on any shape. They are represented internally as “continuous lookup 
tables". To edit the shape of a sketched curve, click on the [edit curve / sketch) item of the Edit 
Sequence Properties menu, this will pop up the Sketched Curve Editor. 


activated: 
subsequences: Normal Concurrent 
anim object: CUBE 
motion type: Rotate 
curve type: Sketched 
start value: (degrees) 27.8 
end value: (degrees) 133.5 
curve edit: [sk N 
doctt-[s) Abort 


0.000 
smooth abort 


0.000 
smooth abort 


The Sketched Curve Editor shows a plot of the curve, a curve value slider, and amenu. When the 
mouse is over the plot, the curve can be “sketched” by holding down the left mouse button. The 
value of the curve represented by the current horizontal position of the mouse is gradually adjusted 
toward the value represented by the vertical position of the mouse. Altering a portion of the curve 


slightly effects nearby portions of the curve. The command menu at the bottom offers these 
choices: 


[smooth] -- At any time during the curve editing session the rough hand-sketched curve can 
be smoothed out with a low pass filter. Pointing at this item while holding down the mouse 
button will continue to smooth the curve. This effectively provides a wider and wider 
smoothing kernal. 


(do it) -- Exit and use the curve as modified during this sketching session. 


Cabor t) -- Exit but revert to the old version of the curve, as before the sketching session. 


Numeric parameters and sliders 


For parameters which have numerical values (such as distances, angles, and scale factors) the menu 
item will show the “units” (the type) as well as the value (in a printed format appropriate to the 
type). Clicking on the item pops up a menu which allows two ways to specify a numeric parameter. 


You can either type in a number or use an interactive slider to adjust the value while displaying the 
relevant frame. 


i Dron > 
name: (Cube Rotate 
activated: Yes No 
subsequences: Normal Concurrent 


anim object: CUBE 
motion type: Rotate 
curve type: Linear 
start value: (degrees) 56.5 
end value: [(dec ) YY 
norte) Abort []- 


adjust with slider 
type in value ; 


Stider range: 


re-center 
expand 
shrink 


Non-Linearity: 


13 
Exit with: 


previous values 


selected value: 


re-center 
expand 
shrink 


Non-Linearity: 


1.3 


Exit with: 
previous values 


selected values 


96.5 


Sider range: 
re-center 
expand 
shrink 


hae gia : 


Vi) 


Exit with: 


previous values 


selected vaiues 


36.5 


Slider range: 
re-center 
expand 
shrink 


Non-Linearity: 


1.3 


Exit with: 
previous values 
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The slider allows the value to be adjusted graphically with the mouse. The box with the large 
numerals on the left side of the slider will track with mouse movements, displaying the “current 
value”. Clicking left will select the current value and redisplay the relevant frame in the 
S-Geometry view window, taking into account the newly adjusted parameter value. This “selected 
value” is marked by a small tick mark on the left margin. You can also “hold down” the left button 
as you slide the mouse to Cause a continuous redisplay as you manipulate the slider. Typically you 
would “click left” to redraw a complicated scene, but “hold down left” for a simple object. 


To exit the slider choose one of the "EXIT WITH" options: 


{previous value] -- This was the value of the parameter when you entered the slider session. 
Clicking here is effective an “abort” since it reverts to the old value. 


[selected value) -- This is the last value selected on the slider. Clicking here causes that 
value to become permanent 


Other aspects of the slider may be adjusted in order to get to the exact value required. The slider 
has a fixed range. The upper and lower limits of this range are displayed at the top and bottom of 
the right hand column. Clicking on these items will allow the limits to be respecified using a 
mini-slider. The range and the linearity (see below) of the slider are initially set to “reasonable” 
values based on the old parameter value and the parameter type, which is based on the motion 
type. For example, angles get an initial range of 360 degrees, centered about the current value. 
The slider operation can also be adjustmented with these items: 


[re-center] -- Causes both ends of the range to be adjusted so that the current value is 
moved to the center of the range. Finer adjustments can be made at the center of the slider. 


[expand] -- Doubles the size of the range while retaining the same center of the range. 
[shrink] -- Cuts the size of the range in half while retaining the same center of the range. 
[non-| ineari ty] -- Pops up a mini-slider to adjust the non-linearity exponent. The slider is 
made to be more sensitive to small adjustments near its center value. A non-linearity value 
of 1 would mean to have constant sensitivity along the slider. Larger non-linearity values 
imply a more and more pronounced increase of sensitivity at the center (and hence less at 
the limits of the range). 
Finally, since some types of sliders do not have the “right hand column utility menu”, a few of the 
slider operations are available on the mouse buttons when the mouse is actually in the slider pane. 
While less obvious to a novice, these short cuts can speed up interaction for the experienced user: 
slider (L) -- Select this value and redraw image. Can be held down for continuous operation. 


slider (M) -- Exit from the slider, returning the last selected value. 


slider (R) -- Recenter the slider about the current value, keeping the range the same size. 


Viewer parameters 


For viewer parameters the menu item will say "(viewer):" followed by a terse printed representation 
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of the viewer value. This printed description is useful primarily to be able to distingush two 
different views. Normally a viewer value is examined or adjusted with the S-Geometry camera 
window. Clicking on the item pops up a menu of ways to specify a viewer parameter. 


nane: [Camera Copy Viewer Ain 
activated: Yes No 
subsequences: Normal Concurrent 
anim object: Canera 
motion type: Copy Viewer Ain 
curve type: Slow-in/Slow-out 
start value: (viewer) Direct-Front, 76 from @ 
end value: [iviever) Slightly Down, Front( Rk). 1Yy from ¥ 
do it ( Abort 


copy view fron 3D-Editor 
adjust this view with 3D-Editor 
copy view from 3D-Editor, then adjust 


The viewer value can be moved from S-Geometry’s camera window to the endpoint value, or vice 
versa, before or after adjusting the view in the window: 


[copy view from 30-Editor] -- The new viewer value for this endpoint is copied from the view 
currently in the S-Geometry’s camera window. 


[adjust this view with 30-Editor] -- First set S-Geometry’s camera to be equivalent to this 
endpoint’s viewer value. Then use the S-Geometry mouse/camera moves to adjust the view 
as though you had clicked (L) on the camera window. Finish the adjustment by clicking (L) 
again. Note that click (R) allows you to execute one S-Geometry command (such as changing 
the [fixed aim) or (global) setting) without exiting from the viewer adjustment loop. 


(copy view from 30-Editor, then adjust] -- Start with the view currently in the S-Geometry 
Camera window, then adjust it with S-Geometry’s mouse/camera moves, as explained above. 


Multiple parameter editing 


Some animation system provide only one style of describing geometrical movements. The most 
common one is refered to as "keyframing”. (This technique is a pale copy of a more complex 
process of the same name in traditional cel animation.) “Keyframe” systems have the user specify 
a set (usually a fixed set) of geometrical parameters at the start and finish of amove. The system 
then interpolates these parameters and applies them in a standard order for each frame in between 
the endpoints. A typical set of parameters would be: a scale factor, “Euler angles” (angles of 
rotation about three standard axes) and X, Y, and Z displacements. 


In such a system, simple movements are easy to specify. But this simplicity comes from a basic 
inflexibility. The user cannot specify the ordering of transformations, which is inconvenient for 
concise motion description, and can lead to serious motion singularities such as "“gymbol lock". 
Keyframing tends to enforce synchronization of interpolation of possibly unrelated motions, this can 
lead to visually obvious artifacts in the motion. Certain motions cannot be represented naturally by 
keyframing. 


S-Dynamics is based on a much more flexible model which does not suffer from these limitations. 
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But the simplicity of keyframing sometimes makes it the most straightforward way to specify 
simple motion. For this reason S-Dynamics supports a generalized form of keyframe specification. 
Basically, it is a convenient way to edit an arbitrary set of sequence endpoint parameter values all 
at the same time. 


The “multiple parameter editor” requires only that a “keyframe” sequence have its subsequence 
mode set to concurrent. Usually the subsequences would be created as a set, but this is not 
required. The sequence (R) / [add subsequences) menu provides several useful sets of operations. 
(See the section "Adding Subsequences” in the chapter "Using the Script Editor”.) Normally a 
keyframe sequence will specify an anim object and acurve type. The concurrent subsequences will 
inherit these properties and provide their own motion type and start value / end value parameters. 
However, these subsequences can just as well specify their own object or curve if required. The 
normal utilities On sequence (R) can be used to rearrange the order of the subsequences as well as 

to create or delete them. To use the "multiple parameter editor”, just click on the start value or 

end value items of a keyframe parent sequence. The item will read (multiple parameter values): 


name: keyfranme-example 
pathname: W: >CWROKEYFRAME-EXAMPLE. script 
franes/sec: 38 fps 
activated: Yes No 
subsequences: Normal Concurrent 


anim object: CUBE 
motion type: None 
curve type: Linear 


start value: 
end value: multiple parameter value 


eo ee gage Abort [() 


The editor will then pop up. On the left side is a normal parameter slider, which is "grayed over”. 
On the right side is a list of “lines” for each of the concurrent subsequences which list their relevent 
properties. 


x-rotate : linear 
y-rotate : linear 
z-rotate : linear 
x-move-to A linear 
y-move-to : linear 
E-move-to ; linear 
scale 1.@8882 linear 


absolute time 


DO IT ABORT 


You click on any line to select adjusting that parameter. When selected, the line is shown in 
boldface type and the slider activates to adjust that parameter: 
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Adjust start paraneter values of subsequences of: 
180.0 


keyfrane-exanple 


Slider range: | CUBE x-rotate 6.6 linear 
re-center | CUBE y-rotate 8.8 linear 
see eh CUBE z-rotate 68.6 linear 
CUBE x-move-to 8.88 linear 
CUBE y-mnove-to 8.8 linear 
1.3 CUBE E-nove-to @.8G linear 
CUBE scale 1.08880 linear 
Exit with: 
previous value: 


8.8 


selected value: 


42.8 


8.08 seconds 1 franes absolute tine 


DO IT ABORT 


Exit from the slider in the normal way to finish adjusting that parameter. You can then select 
another parameter to adjust. When you are finished setting the whole multiple parameter set click 
on [00 IT) to exit and keep all the new values. Or if you Change your mind about some of the 
adjustments and want to revert back to the previous State, click on (ABORT). 


In a future release this "multiple parameter editor" may be redesigned, but old scripts made with it 
will continue to be compatible with the new editor. 


PROGRAMMER'S INTERFACE 


[Note: this chapter discusses advanced topics which are not required in typical S-Dynamics usage. ] 


One of the basic design concepts of S-Dynamics was that it should be easy to do the easy things 
and that it should be possible to do the hard things. The system tries to be a compromise between 
oversimplification (simple things are easy, but hard things are impossible) and overgeneralization 
(anything is possible, but nothing is easy). 


To acheive the first goal, S-Dynamics presents a "soft front end”: the Script Editor, which provides 

a graphical interactive workstyle closely tied to the typical applications. To allow the ability to 

attack the hard problems which are not adequately met by this soft interface, S-Dynamics is fully 
extensible. The basic feature which allows the user to extend the system is the direct connection 
between S-Dynamics and the Lisp programming environment of the Symbolics Lisp Machine. Lisp is 
a very powerful and elegant programming language and can be used to develop extensions to 
S-Dynamics itself, to provide new motion types (as geometrical operations in S-Geometry), and to 
allow the use of S-Dynamics in applications unrelated to S-Geometry. 


There are two ways S-Dynamics might be used in conjunction with a user's application code. One is 
to “layer” another system on top of S-Dynamics: some sort of higher level application which uses 
animation (or scheduling) as a subsystem. For example a “distributed animation production system” 
could be constructed by building some control structure on top of S-Dynamics that would provide for 
coordination between any number of independent computers on a network. Such a system would 
allow animation production to proceed in parallel on all of the machines hence providing a large 
speed improvement. Implementing such a system would involve making calls into the S-Dynamics 
software from the user’s code. This part of the programmer’s interface is not finalized at this time 
and so will not be described in this document. In a future release this specification will be 

formalized and documented. 


The other way S-Dynamics interacts with user software is to provide “hooks” which allow user code 
to be called from S-Dynamics as part of the normal animation process. The basic facility which 
makes this possible is called the frame action of asequence. The user can supply a Lisp form 
which will be evaluated ("run") in place of a sequence’s “default frame action”. 


Sequences each have associated with them certain properties, perhaps via the inheritance 
mechanism. Among these are an “anim object”, a "motion type” and a parameter value (specified in 
terms of two end values and an interpolation curve and style). In Lisp (Flavors) object oriented 
programming, the “anim object" is an instance of a flavor, the "motion type” is a message name, 
and the parameter corresponds to a argument to the message. For each frame that a sequence is 
active, it performs the equivalent of this “default frame action” form (send is the Lisp function for 
sending messages to object instances): 
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(send <anim-object> <motion-type> <current-interpolated-parameter-value> ) 


But you can provide another expression to be evaluated in place of this default. In the current 
release this facility is not made apparent on the sequence property menu so that is does not 
confuse the novice user. In order to set up a frame action, go to the Script Editor and select the 
specific sequence you want to modify (eg: click (R) on the sequence, then click on [select this)). 
Then select a Lisp Listener and type this form: 


(send (send dyna:se :current-sequence) :set-frame-action t) 


This gives the currently selected sequence of the current script editor a non-nil frame action. Now 
when you edit the properties of this sequence (click (4) on sequence diagram) you will see a new 
item called (frame action) which will show a current value of T. You can click on this item to 
change it by typing in any valid Lisp expression. For example, change it to (beep) and animate the 
script, this will cause the console to beep once every frame during the animation of that sequence. 


name: Joe 
activated: Yes No 
subsequences: Normal Concurrent 
frame action: (beep) 


anim object: None 
notion type: None 
curve type: None 


To aid in the writing of frame action expression, several “global variables” are bound to relevent 
values around the evaluation of the user-provided form. These have self explainatory names: 


dyna: xcurrent-timex 
dyna: xcurrent- frame-numberx 


dyna: xcurrent-sequencex 

dyna: xcurrent-sequence-valuex 

dyna: xcurrent-sequence-mot ion-typex 
dyna: xcurrent-sequence-ani m-ob jectx 


This means that the equivalent of the default frame action would be this form: 


(send dyna: xcurrent-sequence-anim-ob ject 
dyna: xcurrent-sequence-mot ion-typex 
dyna: xcurrent-sequence-valuex) 


And so it is possible to replace just portions of the default frame action mechanism. For example, 
to provide your own function of time to calculate the parameter value (but to otherwise do the 
normal thing): 


(send dyna: xcurrent-sequence-anim-ob jectx 
dyna: «curr ent-sequence-mot ion-typex 
(YOUR-FUNCTION dyna: xcurrent-timex) ) 


Of course, the expression that you use for a frame action need not refer to any of these globals. 
They exist merely to allow the frame actions to get at the current sequence state conveniently. 


EXERCISES 


Exercise -- Create a script and animate it. 


uc 


Pee 


Press SELECT G to select the S-Geometry frame (or to create it if one does not already exist). 
Move the cursor to the gray area below the basic interface menus and click (R). 
Click on (select configuration] 


Click on [DYNAMICS] to switch to S-Dynamics configuration of S-Geometry frame. This moves 
the S-Geometry panes up in the frame and adds the S-Dynamics Script Editor at the bottom. 


(select sequence] / (create new script] 


Type the name of the new example script in the pop-up window. Use “example” as the name. 


Create a CUBE (with default parameters) in S-Geometry to use in the script. 
[modes] / [make axes visible] Makes the major axes visible. 


Adjust the view with mouse the so that the Z axis runs out of the frame on the upper right 
side. This view will be used by default for most of the rest of this exercise. 
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Ue 


12. 


13. 


14, 


15. 
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Increase the length of the animation from the default one second. Place the mouse at the 
end time of the script and click (R). Click on [1 second), then (type in value), thenclick on 
(1) and type in 2 followed by aRETURN. Click on fend). Click on (Do It). The sequence now 
extends past the edge of the script diagram. To zoom out to the new sequence boundaries: 
click (R) on the script diagram, click on [select this). The status line and the frame tick 
mark will update to correspond. 


Create a sequence to control the motion of the 3D object. (R) on the script diagram. Use 
(add sub-sequences / add one]. The outline of the script is still displayed, and the new 
sequence diagram is inside. 


Click (M) on the new subsequence to edit its properties. Use [anim object). Select the name 
of the 3D object from the menu. Click on (Do it). The name is automatically updated to 
"Cube Mover". Note how the left and right extent of the Sequence diagram correspond to the 
Start and end times of the action. To change the endtime, click (L) on the diagram end and 
move with the mouse. Click (4) on both ends to expand them to the script boundaries. (This 
implies that Cube is active for the whole script.) 


Create a subsequence to control the first aspect of the motion of the object. Click (R) on the 
"Cube Mover” diagram. Use [add sub-sequences / add one). Click (M) on the start and end 
points to expand the subsequence to the length of the script. Edit the properties of the new 
subsequence called "Cube Mover/0". Note that the anim object is inherited from the parent 
sequence. 


Select a rigid translation along the Z axis. Use {motion type] / [object translations) / 
[move global in Z). Note that the subsequence name updates. Use [curve type] / (linear). 
Note the new items for start and end times. The default end value, Zero, is used for the end 
time, meaning that the object will finish in this position. 


Set the start position. Use (start value] / lad just with slider]. Move the mouse to track. 
Hold down the left mouse button and move the mouse to indicate the motion of the 3D object 
along the Z axis. Rock the cube back and forth until it is just barely visible inside the right 
edge of the frame. Click on [selected value) to exit from the slider with this value. Use 

(Do it) to finish editing the subsequence properties. (See figure, next page.) 
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16. Now you are ready to create a motion test of the first version of the script. Use [Animate 
Script]. For now, use the default settings on the menu and just click on (Do It). As it runs, 
each frame is described by S-Dynamics and passed over to S- -Geometry to make an image, 
and that raster data for each frame is recorded for playback later. 


17. Use (Playback / Forward Once) and watch the run through once. Experiment with the other 


playback menu choices. In the looping modes, type any character (or click the mouse) to 
exit. 


Exercise -- Change the Curve Type 


In this exercise, you will improve the motion in script you created in the previous exercise. 

1. (L) on the sequence to open it. You see a plot of its linear interpolation curve. A linear 
interpolation curve like the one you see here is not very “realistic”, because the motion of the 
object comes to an abrupt stop at the end of the action. This exercise changes this linear 
Curve to provide a smoother motion. 

2. (mM) on the inner sequence. 


3. Change [curve type] to [slow-out). 


4. Click on {do it). Note the shape of the new “slow out” curve. 
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5. Re-animate the script using [Animate script) / [Re-use Previous Recording). 


6. Playback the result. Note how the object now smoothly decelerates at the end of its motion. 


Exercise -- Use a Sketched Curve 

In this exercise, you will improve the motion in script you created in the previous exercise. 
1. (mM) onthe inner sequence. 

2. Change [curve type] to (sketched). 

3. Click on (curve edit) / (sketch) to invoke the sketched curve editor. 


~ 


4. Edit the curve shape to look something like the example in the section "Curve Type” above. 
This “ramp blending into a slow-out” would correspond to gliding in and then decelerating toa 
stop. 

5. Click on {do it]. Note the shape of the new sketched curve in the plot. 

6. Re-animate the script using (Animate script] / [Re-use Previous Recording). 


7. Playback the result. The object should seem to drift and then slow toa stop. 


8. Use [playback] / [scrol! with mouse) to rock the playback back and forth across the point 
where the curve begins to slow out. Note the correspondence between the playback of the 
animation and the curve shape near there. 


Exercise -- Add an independent rotation 
In this exercise, you will add another motion to the script you used in the previous exercises. 


1. Click (L) on the inner sequence to close it, click (R) for the menu, use [select parent]. The 
current sequence should now be "Cube Mover”, check the status text in the upper right corner. 


2. Click (R) on that outer sequence (near the top or bottom of the diagram -- outside the inner 
sequence). Use [add subsequences] / [add one]. The new sequence will appear at the bottom 
center -- leave it there for now. (See figure, next page.) 
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3. Click (M) on the new sequence. 

4. Click on [motion type] / {object rotations) / [Z rotate). 

8. Click on (curve type] / [slow in/slow out) 

6. Click on [end value) / [type in value] and then type 98 and RETURN. 

7. Click on [do it). 

8. Re-animate the script. 

9. Playback the result. The object should rotate 90 degrees around the axis it is moving along. 


10. Using (pltayback] / [scrol! with mouse] note that the rotation happens only during the frames 
covered by the new sequence. 


11. Move the endpoints of the new sequence (using (L) on the sequence diagram endpoints). 


12. Re-animate the script. Note that the same rotation happens, but at a different time. 
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Exercise -- Add a Camera Move 


In this exercise, you will improve the script you used in the previous exercises by adding a camera 
move. 


1. (R) on any sequence. 

2. (Select script). 

3.  (R) onthe script. 

4. Addatop level sequence. It will appear parallel to "Cube Mover”. 
§. Expand it to a full script length. 

6. (Mm) on sequence to edit its aris 

7. [anim object) / [camera] to animate the cartes: 


8. [motion type] / (camera operations] / [interpolate between views] to select the motion type 
which will make the camera do a simple transition from one view to another. 


9. [curve type] / [linear] Note that the (start value] and [end value) items appear and are 
initialized to the "default viewer”. 


So far, this does a simple linear interpolation of a set of camera parameters (collectively called a 
“viewer") from a starting view to an ending view. Up to now the script has not specified a view, by 
default you have been using the “viewer” set in the 3D editor's camera window during the first 
exercise. Now, to define the starting camera position as that same view: 


10. Set (start value] with (copy view from 30 Editor). 


11. Edit tend value) with {copy view from 3D Editor, then ad just). This puts you into the same 
mouse tracking, camera adjusting mode that you get by clicking (L) on the 3D Editor’s camera 
window. 


12. Move around until you have the view you want. For this exercise, a subtle shift to the left 
and dropping down a bit gives the point of view some "float". This makes the point of view 
seem more alive and less mechanical. The 3D Editor modes are in effect, for example, , 
"fixed aim" mode affects your motions. To change the 3D Editor modes, click (R) allows you 
to execute a single command without exiting the adjustment mode. Click (L) to quit 
adjusting and use that view. 


13. Re-animate the script using [Animate script) / [Re-use Previous Recordi ng]. 

14. Playback the result. 

15. Experiment with changing some other aspect of the viewer State, such as changing the view 
angle in S-Geometry with the {zoom +] mode, or changing the aim point. After making these 


adjustments to the camera window, incorporate them back into the script with (copy vieu 
from 30 Editor] and re-animate. 


